home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / schools / sciapps / _scigraph / _help < prev    next >
Text File  |  1992-05-19  |  5KB  |  133 lines
  1.  
  2.      /-------------------------------------------------\
  3.      | !SciGraph - by Dr. Roderick Ferguson, May 1992. |
  4.      \-------------------------------------------------/
  5.  
  6.     !SciGraph is a RISC OS 'desktop friendly' Scientific graph
  7. drawing application. It does NOT itself draw the graph, but it
  8. can produce a DrawFile containing the graph. This output file
  9. can then be loaded into !Draw or any DTP package which accepts
  10. DrawFiles.
  11.  
  12.     This application can also be used along with the '!SciModel'
  13. application to analyse data according to a given theoretical
  14. model (by doing a nonlinear least squares curve fit on the data).
  15.  
  16.  
  17.     Features supported in this latest version of !SciGraph are:-
  18.     -----------------------------------------------------------
  19.  
  20. (a) Up to 10 data files with up to 400 data points per file can
  21.     be used by the program.
  22.  
  23. (b) Thirteen different point styles can be used for any data set.
  24.  
  25. (c) The data points can be joined either with straight lines or
  26.     with '!Draw style' bezier curves (using a 'full' or a 'dashed'
  27.     line style).
  28.  
  29. (d) If a theoretical model description has been included into
  30.     the SciGraph data file, then the curve obtained from the
  31.     model can be drawn (again using a 'full' or a 'dashed'
  32.     line style).
  33.  
  34. (e) Error limits for each data point can be dealt with.
  35.     (Y values only).
  36.  
  37. (f) The graph can be titled and the axes labled using Draw's
  38.     "Text Area Objects". However, better effects such as
  39.     vertical Y axis text (or even rotated text) can only be
  40.     obtained with the Public Domain application "!DrawPlus"
  41.     or with the new RISC OS3 '!Draw' application.
  42.  
  43. (g) Data 'auto-scaling' can be turned off or on from the
  44.     'Graph Scale' window.
  45.  
  46. (h) More sophisticated curve & line drawing routines means that
  47.     all curves and lines are 'clipped' so that nothing is drawn
  48.     outside the main graph limits (where the limits are
  49.     specified by Xmin,Ymin and Xmax,Ymax in the Graph Scale window).
  50.  
  51.  
  52.     To get more help when using this program, use the interactive
  53. help application, "!Help".
  54.  
  55.    I have used earlier versions of this application (together with
  56. the !SciModel application) to produce both PhD thesis & publication
  57. quality figures for a variety of projects.
  58.  
  59.    SciGraph data files can be created using !Edit (see the notes at
  60. the end of this file).
  61.  
  62.  
  63.    COPYRIGHT NOTICE  
  64.    ================
  65.  
  66.    The !SciGraph, !SciModel & !SciTrans applications together with the SciGraph
  67. data file format are all © Dr. Roderick Ferguson.  Furthermore, you use this
  68. software at your own risk! The author accepts no responsibility whatsoever
  69. for any damage caused by these applications whether to Hardware or other software
  70. or to other people.
  71.    However, not withstanding the above, I should tell you that these applications
  72. have been tested for at least a year now and they should be 99.9% bug free.
  73. If you DO find any bugs "unsupported extra features" then please let me know!!
  74.  
  75. I can be contacted by :-
  76.  
  77.     Letter       Polymer Laboratory,
  78.     ------       Chemistry Department,
  79.                  Heriot-Watt University,
  80.                  Riccarton Campus,
  81.                  Edinburgh, Scotland.
  82.                         
  83.     Phone        031-449-5111 (extension 4109 or 4239).
  84.     -----
  85.  
  86.     Email        CHERRF@UK.AC.HERIOT-WATT.VAXA
  87.     -----
  88.  
  89.  
  90.  
  91. ======================================================================
  92.     For the sake of completeness, I will briefly describe
  93. the format of a SciGraph data file (file type = &2FF) :-
  94.  
  95.    The format used is CSV (comma seperated value).
  96.  
  97. 1) The first line(s) in the file can be comment line(s), which
  98.    start with a '*'.
  99.  
  100. 2) The Data section starts with the keyword 'DATA'. This is
  101.    followed by the number of data points and the standard error
  102.    assosciated with each data point. This can be overrided 
  103.    however by including a seperate standard error (ErrY) for
  104.    each data point after its X,Y values.
  105.    The X,Y and ErrY data follow (with one line per data point).
  106.  
  107. 3) The Model description section starts with the 'MODEL'
  108.    keyword. This is followed by the model description, then two
  109.    lines which are the model function and an optional auxiliary
  110.    function. This latter function can greatly simplify the form
  111.    of the algebraic expressions used for the partial derivatives
  112.    later on. The number of parameters is next, then lines
  113.    containing each parameter and a flag indicating if this
  114.    parameter is to be frozen during the curve fit or allowed to
  115.    vary. Finally, one has the expressions for the partial
  116.    derivatives of the main function with respect to each
  117.    adjustable parameter Pi.
  118.  
  119. 4) The !SciGraph 'LEGEND' keyword. After this keyword, one can
  120.    have lines for the Graph Title, the X axis legend and the Y
  121.    axis legend. Finally, one has the two scientific notation
  122.    flags (again, one per line) 0 = don't use scientific notation
  123.    for the axis numbers, and -1 = use scientific notation for
  124.    the axis numbers.
  125.  
  126. Inspection of the 'demo' SciGraph data files in the 'SciGraph'
  127. directory supplied with this application illustrates the format used.
  128.  
  129.    Also, note that lines corresponding to section (f) can be ommitted,
  130. and a model description chosen from the !SciModel main menu and
  131. the data file saved (after performing a curve fit).
  132. ======================================================================
  133.